package com.draven.system.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.draven.common.core.BasePageQuery;
import com.draven.common.entity.Note;

import java.util.List;

/**
 * 笔记Service接口
 * 
 * @author draven
 */
public interface INoteService extends IService<Note> {

    /**
     * 查询笔记分页列表
     * 
     * @param note 笔记信息
     * @param pageQuery 分页查询参数
     * @return 笔记分页列表
     */
    IPage<Note> selectNotePageList(Note note, BasePageQuery pageQuery);

    /**
     * 根据标签ID查询笔记列表
     * 
     * @param tagId 标签ID
     * @param pageQuery 分页查询参数
     * @return 笔记列表
     */
    IPage<Note> selectNotesByTagId(Long tagId, BasePageQuery pageQuery);

    /**
     * 查询最近笔记
     * 
     * @param limit 限制数量
     * @return 笔记列表
     */
    List<Note> selectRecentNotes(Integer limit);

    /**
     * 查询热门笔记
     * 
     * @param limit 限制数量
     * @return 笔记列表
     */
    List<Note> selectHotNotes(Integer limit);

    /**
     * 根据笔记ID查询笔记详情
     * 
     * @param noteId 笔记ID
     * @return 笔记信息
     */
    Note selectNoteById(Long noteId);

    /**
     * 新增笔记
     * 
     * @param note 笔记信息
     * @return 结果
     */
    int insertNote(Note note);

    /**
     * 修改笔记
     * 
     * @param note 笔记信息
     * @return 结果
     */
    int updateNote(Note note);

    /**
     * 批量删除笔记
     * 
     * @param noteIds 需要删除的笔记ID
     * @return 结果
     */
    int deleteNoteByIds(Long[] noteIds);

    /**
     * 删除笔记信息
     * 
     * @param noteId 笔记ID
     * @return 结果
     */
    int deleteNoteById(Long noteId);

    /**
     * 增加浏览量
     * 
     * @param noteId 笔记ID
     * @return 结果
     */
    int incrementViewCount(Long noteId);

    /**
     * 增加点赞量
     * 
     * @param noteId 笔记ID
     * @return 结果
     */
    int incrementLikeCount(Long noteId);

    /**
     * 设置笔记置顶状态
     * 
     * @param noteId 笔记ID
     * @param isTop 是否置顶
     * @return 结果
     */
    int updateTopStatus(Long noteId, Integer isTop);

    /**
     * 设置笔记公开状态
     * 
     * @param noteId 笔记ID
     * @param isPublic 是否公开
     * @return 结果
     */
    int updatePublicStatus(Long noteId, Integer isPublic);
}